home *** CD-ROM | disk | FTP | other *** search
/ Stac Reachout 7 / Stac Reachout 7.iso / STACFAX / 8102.TXT < prev    next >
Text File  |  1997-01-31  |  7KB  |  149 lines
  1.       -----------------------------------------------------------------
  2.       STAC NOTE                                               STAC NOTE
  3.                             INSTALLATION SCRIPTS
  4.                   (Applies to ReachOut versions 4.04, 5.X)                                                        
  5.       STAC FAX  8102 (01/96)
  6.       -----------------------------------------------------------------                                      
  7.                                       
  8.       Installing ReachOut using a script file to answer Install
  9.       questions.
  10.       
  11.       This documentation discusses developing an installation script
  12.       for ReachOut. It is intended for the person responsible for
  13.       installing software on the network or on individual workstations
  14.       for multiple users. A script can be used with ReachOut's Install
  15.       Public utility, or from the floppy disk. If  the script will be
  16.       used from a floppy disk, copy the script file to all the ReachOut
  17.       disks. If the script is being used with a network installation,
  18.       also see StacFax 8101. Most of the references in this document
  19.       assume a network installation.
  20.       
  21.       Note:  Version 5.X users should see the ReachOut on-line Help for
  22.       additional features and syntax. Open ReachOut Help, search for
  23.       Install, and select To Create an Installation Script. All the
  24.       keywords as well as a sample script are also provided in the on-
  25.       line Help. The version 5-unique keywords are also at the end of
  26.       this document. Where there is a conflict between the ReachOut
  27.       User's Guide and the on-line Help, rely on Help. Manuals must be
  28.       written before product release, and may not incorporate all the
  29.       latest updates to the software.
  30.       
  31.       The use of a Script File allows you or your users to run INSTALL
  32.       without being asked any questions, thus reducing errors. In
  33.       addition, certain switches added to the INSTALL command allow for
  34.       customized installations.
  35.       
  36.       Any answers that are left blank in the Script File will be asked
  37.       during the installation. Thus, if all of your users had similar
  38.       configurations, you might make up a Script File called ME. Put
  39.       the files on a shared network drive along with the Script File,
  40.       ME, and tell your users to log on to that drive and type:
  41.       
  42.                 INSTALL ME
  43.       
  44.       There is a default script file named 'ROINST' that, if found in
  45.       the directory that INSTALL is run from, will automatically be run
  46.       without specifying it on the command line. Important! If you are
  47.       installing from diskette or from multiple network directories,
  48.       the script file must be copied to each diskette or network
  49.       directory. Each module that runs during the installation needs
  50.       the file.
  51.       
  52.       First, a copy of ReachOut should be installed to a network drive.
  53.       This will be the shared copy of the executables. From DOS, run
  54.       SECURITY, and select Dissallow Private Password Directory, save
  55.       and exit. This will prevent users from creating their own
  56.       passwords, and locking you out. This will allow a Viewer to
  57.       connect to a Host using any of the passords from the shared
  58.       password list. Note: If you will be running the Windows Host do
  59.       NOT use the Supervisor Security option 'Use Supervisor Directory
  60.       for Passwords.'
  61.       
  62.       The answers are not all required. Not all answers apply to both
  63.       the network and modem product (version 4.04.)
  64.       
  65.       To use a Script File, using any text editor, create a file using
  66.       the following answers;
  67.       
  68.        type=host / viewer / both
  69.        mode=Windows / DOS / both
  70.        network=NetBIOS / IPX / BANYAN /SAP / FTP
  71.        server=xxxxx (NetWare IPX server name) <blank = none>
  72.        source=xxxx (source path, for executables, install from path)
  73.        target=xxxx (private users path, install to path)
  74.        name=xxxx (user name or %1) <blank = none>
  75.           (%1 allows install <script file name> <machine name>)
  76.        auto (auto-load these responses without asking the user to
  77.            verify the information)
  78.        hidden (to not display the installation process)
  79.        raserver (to add Remote Access RASERVER to the batch files)
  80.        raclient (to add Remote Access RACLIENT to the batch files)
  81.        ranone (to NOT add Remote Access to the batch files)
  82.        public (to share the executable files from a network drive)
  83.        nogroup (will not create Windows group)
  84.        group=Reachout (to create group name)
  85.        icons=Viewmenu.exe, Viewer Menu; Hostmenu.exe, Host Menu;
  86.           (to create icons, <program name>, <program description>;
  87.            etc...)
  88.        graphics=yes / no (for DOS Graphics)
  89.        nopassword (to skip entering passwords)
  90.        noreadme (to skip readme)
  91.        nomodem (to skip asking for a modem configuration)
  92.        nocomm (to skip asking for a comm port or ACS configuration)
  93.        execute=<filename.ext> (at end of install, exit Windows,
  94.            execute program, then run Windows, Can not do a batch file)
  95.        exit (to exit windows after the Install)
  96.        
  97.        A sample script that would allow a user to install by typing;
  98.                     INSTALL ME TEST
  99.       Would run the installation using the script file ME, and the name
  100.       TEST would be would be passed to the script for the machine name.
  101.       The variables %1 and %2 can be used.
  102.        type=both
  103.        mode=both
  104.        network=IPX
  105.        server=TECH
  106.        source=p:\reachout
  107.        target=h:\home\%1
  108.        name=%1
  109.        auto
  110.        raserver
  111.        raclient
  112.        graphics=yes
  113.        nopassword
  114.        noreadme
  115.        public
  116.        icons=Viewmenu.exe, Viewer Menu; Hostmenu.exe, Host Menu;
  117.  
  118.       Keywords valid with ReachOut version 5 only
  119.       
  120.       autostarthost=yes/no
  121.       comm=ACS/Direct/Modem/Network
  122.       companyname=company/[blank]
  123.       file=no/1/2/4/8  (background ReachOut file manager on host, # is
  124.       buffer size in KB)
  125.       int=hexadecimal_integer   (interrupt vector for FTP TCP/IP, from
  126.       32 to FF)
  127.       restartwindows
  128.       username=username
  129.       exit (to exit windows after the Installation) should be
  130.       EXITWINDOWS
  131.       network=NetBIOS / IPX / BANYAN /SAP / FTP has new options SPX
  132.       (same as IPX) and Winsock
  133.       
  134.       If REACHOUT.INI is in the same directory that INSTALL is run
  135.       from, then it will be copied to the Windows directory at
  136.       installation time. This allows the system administrator to pre-
  137.       configure ReachOut Windows settings in REACHOUT.INI.
  138.       
  139.       A pre-configured MODEM.RCH and EMULATOR.RCH can also be copied 
  140.       during installation by adding them to REACHOUT.INS (ver 5) or
  141.       SERIAL.INS (ver 4). Edit  the INS, and add them after File 
  142.       "PHONEBK.MDM" 146 28 (ver 5) or "PHONEBK.MDM" 146 15 (ver 4).
  143.       This entry is filename, file size, and the group number (28 in
  144.       ver 5 and 15 in ver 4). Any file can be copied during the 
  145.       installation by this method.
  146.  
  147.       -----------------------------------------------------------------
  148.       Copyright 1995 Stac, Inc.
  149.